option

Type

command

Summary

Displays an option menu whose menu items are buttons in a stack.

Syntax

option <stack>

Description

Use the option command to display a stack menu as an option menu in situations where it is not possible to attach the menu to a button (for example, if the contents of the menu are not known in advance).

Use the option command in a mouseDown handler to display the menu :

    on mouseDown
        option stack \"Help Menu\"
    end mouseDown

While the menu is displayed, the handler pauses.

The menu appears centered over the center of the control containing the handler. Choosing a menu item from the menu sends a mouseUp message to the stack.

Parameters

Name	Type	Description
stack		Any stack reference. The stack's first card must contain a button for each menu item in the option menu.

Examples

option stack "Hot Text Items"

option stack (the menuStack of this image) -- custom property

Related

command: pulldown

function: menuButton

glossary: menu item, stack menu, handler, button, message, menu, command

message: mouseDown

object: stack, button

property: menuName, menuLines

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

server